home *** CD-ROM | disk | FTP | other *** search
/ Sound Fx / Sound Fx.iso / Software / UNZIPED / SBPLY254 / SBPLAY.DOC < prev    next >
Text File  |  1996-12-06  |  8KB  |  159 lines
  1.  
  2.         SBPLAY version 2.54 December 6, 1996 by John A. Ball
  3.  
  4.         SBPlay is a utility for playing back sound files. It works with
  5.         Sound Blaster compatiable cards and other types of sound cards with
  6.         the use of DIGPAK drivers. It will also use the regular PC speaker.
  7.         It does not require a sound board. To use the program type
  8.  
  9.         SBPLAY filename or SBPLAY
  10.  
  11.         where filename is the path to the file if required and filename can
  12.         include wild card characters. Filename extensions are not required.
  13.  
  14.         SBPlay works with any Sound Blaster compatiable sound card or your
  15.         pc speaker. Other sound cards are supported using a DIGPAK driver.
  16.         To use SBPlay with a DIGPAK driver you must install the DIGPAK
  17.         driver before using sbplay. I.e. type
  18.         SNDSYS    to install the driver and then use
  19.         SBPLAY    to play your sound files on a Windows Sound System board.
  20.  
  21.         After you are done the resident sound driver can be removed by
  22.         SNDSYS U
  23.  
  24.         Version 2.54 will play back Tandy Sound files (SND), Creative Labs
  25.         (VOC), Microsoft (WAV), Apple (AIF) and Amiga (IFF) & (RAW) files.
  26.         There is also some support for MAC files and .AU files.
  27.         SBPlay will also play the samples in (MOD) files at the last used
  28.         frequency. Try using the /X command line option to see the song
  29.         patterns. It will try to play back unknown files or raw data files
  30.         such as MAC SND files at 11,000 samples per second. The sound files
  31.         should be uncompressed, 8 bits, and unsigned. Note other types of
  32.         files can be played by using the command line options to change the
  33.         defaults. I.e. R:22000 to change the playback speed to 22,000 samples per
  34.         second.
  35.  
  36.         SBPlay will also rip sound samples from MOD files and will create
  37.         the SAM sample files which were used to create the original mod file.
  38.         SAM files are used by MOD editors to create MOD files and usually
  39.         contain musical instrument sounds or other sound effects. WAV and
  40.         VOC sound files can also be created.
  41.  
  42.         SBPlay can be used to play a randomly selected sound file from a
  43.         directory with the /RAN switch. This can be used to play a different
  44.         sound file each time the computer boots by placing the following
  45.         command in the autoexec.bat file:
  46.  
  47.            SBPLAY c:\sound\*.* /s/ran
  48.  
  49.         where c:\sound is a directory containing sound files. The /s prevents
  50.         any file information from being shown on the screen and the /ran
  51.         selects any one of the files that are available.
  52.  
  53.         SBPlay is compatiable with DESQview, Windows 3.1/95, and OS/2.
  54.         It can be used to play back sound files by associating the sound file
  55.         extension with SBPlay in windows and DOSShell.
  56.  
  57.         Note: When using SBPlay in DESQview your system may lock up! For
  58.         best results use a full text screen and don't enable the background.
  59.  
  60.         If a mouse and mouse driver is present then SBPlay will use it to
  61.         select and play files. Try clicking the left mouse button on the
  62.         file to be played or the command.
  63.  
  64.         The main program is written in C and the sound routines for the PC
  65.         speaker and Sound Blaster card are written in assembler. I used
  66.         QuickC 2.51 with Assembler to create this program. The source
  67.         code is available see register.me for details.
  68.  
  69.         There are limitations to this program.
  70.  
  71.         1) SBPLAY does not play back ALL sound files which have been
  72.            compressed.
  73.         2) There are audio gaps during the playback of large sound files
  74.            on slow PCs and when using a multitasker. SBPlay will use EMS
  75.            memory to load all or as much of the sound file as possible into
  76.            expanded memory for playback.
  77.         3) The volume control works only with Sound Blaster Pro and 16 cards.
  78.         4) If you have a CD Rom drive with no cd in it when you change drives
  79.            with the F3 command the infamous dos abort, ignore, retry error
  80.            occurs. Choose the ignore option or put in a cd.
  81.         5) SBPlay supports 8bit mono and stereo playback on Pro and 16 cards.
  82.            It does not use 16bit playback mode.
  83.  
  84.         Problems:
  85.  
  86.         SBPlay uses the DOS environment to help find the hardware
  87.         configuration. It looks for the BLASTER variable to determine what
  88.         the hardware address is, the IRQ, the DMA channel, and the board type.
  89.  
  90.         i.e.
  91.  
  92.         SET BLASTER=A220 I5 D1 T3
  93.  
  94.         will tell SBPlay that the Address is 220h, the IRQ is 5, the DMA
  95.         channel is 1, and the card type is 3 (SB ver 2.0). If your board
  96.         is configured for another DMA channel such as 0, the D parameter
  97.         must be D0 . If you have a Sound Blaster compatiable card and SBPlay
  98.         locks up try using T-1 to tell SBPlay that your card is not a Sound
  99.         Blaster card. If the hardware address or IRQ is not correct in the
  100.         BLASTER variable SBPlay should give you an error message and you can
  101.         use the /x parameter on the command line to find the correct hardware
  102.         information.
  103.  
  104.         Starting with version 2.54 you can save your defaults with the
  105.         save defaults command in the defaults menu F1. The defaults are
  106.         saved in SBPLAY.INI in whatever directory you are in unless you
  107.         have the SOUND environmental statement in your autoexec.bat.
  108.         For example
  109.  
  110.         SET SOUND=C:\BLASTER
  111.  
  112.         in your autoexec.bat file will cause SBPlay to save it's SBPLAY.INI
  113.         file in the C:\BLASTER directory.
  114.  
  115.         Also new is the registeration command @ . This command is used for
  116.         saving your name as the registered user and the registration number
  117.         obtained from the author John A. Ball. There is a password required
  118.         in order to use this command which can be otained via e-mail by
  119.         registering! Please read the file register.me .
  120.  
  121.         When using a CD-ROM if you go to change drives and there is no cd
  122.         in the drive you will get the abort, retry,, ignor error. Place a
  123.         cd in the drive and go r (retry) or use i (ignore). If you wish
  124.         to convert a sound file such as an aif to wav that is on a cd, type
  125.         the drive and directory you want the converted file saved to when
  126.         asked the name of the file.
  127.  
  128.         When using the file shell there are commands to delete, rename, and
  129.         copy files. The delete command is d. The rename command is r. And
  130.         the copy command is c. 
  131.  
  132.         Also sbplay may be used to play a sound file continuously upto
  133.         32,000 times using the command line mode L:xxxxx , where xxxxx is
  134.         the number of times to play the sound file. Good for a noise or
  135.         special effects file.
  136.  
  137.         The use of this program is free but you must register your use of
  138.         this program. By registering I receive the feedback required to
  139.         keep me supporting this program and improving it. 
  140.         
  141.         You may modify and use the source code for your own programs. You 
  142.         may not distribute modified code. Do not distribute any of my source 
  143.         code without my permission. Please send all corrrections and 
  144.         suggested improvements to John A. Ball.
  145.  
  146.         Comments and suggestions may be sent to
  147.  
  148.         ad008@freenet.unbc.edu or
  149.         jaball@netbistro.com
  150.  
  151.                 John A. Ball
  152.                 2398 Victoria Street
  153.                 Prince George, B.C.
  154.                 V2L 2M2
  155.                 Canada
  156.  
  157.         Thank-you for trying my program.
  158.  
  159.